package com.it.machine.mapper;

import java.util.Date;
import java.util.List;
import com.it.machine.domain.ActivationCode;

/**
 * 激活码Mapper接口
 * 
 * @author 云淡风轻
 * @date 2025-05-08
 */
public interface ActivationCodeMapper 
{
    /**
     * 查询激活码
     * 
     * @param id 激活码主键
     * @return 激活码
     */
    public ActivationCode selectActivationCodeById(Long id);

    /**
     * 根据激活码查询
     * 
     * @param activeCode 激活码
     * @return 激活码
     */
    public ActivationCode selectActivationCodeByCode(String activeCode);

    /**
     * 查询激活码列表
     * 
     * @param activationCode 激活码
     * @return 激活码集合
     */
    public List<ActivationCode> selectActivationCodeList(ActivationCode activationCode);

    /**
     * 新增激活码
     * 
     * @param activationCode 激活码
     * @return 结果
     */
    public int insertActivationCode(ActivationCode activationCode);

    /**
     * 修改激活码
     * 
     * @param activationCode 激活码
     * @return 结果
     */
    public int updateActivationCode(ActivationCode activationCode);

    /**
     * 删除激活码
     * 
     * @param id 激活码主键
     * @return 结果
     */
    public int deleteActivationCodeById(Long id);

    /**
     * 批量删除激活码
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteActivationCodeByIds(Long[] ids);
    
    /**
     * 根据用户ID查询激活码列表
     * 
     * @param allocateUserId 分配用户ID
     * @return 激活码集合
     */
    public List<ActivationCode> selectActivationCodesByAllocateUserId(Long allocateUserId);
    
    /**
     * 根据项目ID和用户ID查询未分配的激活码
     * 
     * @param activationCode 项目ID和状态
     * @return 激活码集合
     */
    public List<ActivationCode> selectUnallocatedActivationCodesByProId(ActivationCode activationCode);
    
    /**
     * 批量更新激活码的分配用户
     * 
     * @param activationCode 激活码信息
     * @return 结果
     */
    public int batchUpdateAllocateUser(ActivationCode activationCode);
    
    /**
     * 分配激活码给用户
     * 
     * @param ids 激活码ID数组
     * @param allocateUserId 分配用户ID
     * @param allocateUserName 分配用户名
     * @param updateTime 更新时间
     * @return 结果
     */
    public int allocateActivationCodesToUser(Long[] ids, Long allocateUserId, String allocateUserName, Date updateTime);
}